Skip to content

[DOC] Update documentation for running tests with local Docker services#1717

Open
MOHITKOURAV01 wants to merge 1 commit intoopenml:mainfrom
MOHITKOURAV01:doc/update-local-services-testing
Open

[DOC] Update documentation for running tests with local Docker services#1717
MOHITKOURAV01 wants to merge 1 commit intoopenml:mainfrom
MOHITKOURAV01:doc/update-local-services-testing

Conversation

@MOHITKOURAV01
Copy link

Metadata

Details

  • What does this PR implement/fix?
    Updates the documentation to explain how contributors can run the test suite using local Docker services, as introduced in [MNT] Dockerized tests for CI runs using localhost #1629 and [MNT] Update CI/CD with local test server and dependency matrix #1697.

    Changes made:

    • Added a new "Running Tests Against Local Services" section to docs/developer_setup.md
    • Added the same instructions to CONTRIBUTING.md under the testing section

    The documentation covers:

    • Cloning the openml/services repository
    • Setting file permissions (chmod -R a+rw ./data ./logs)
    • Starting Docker services with the correct profiles (rest-api, minio, evaluation-engine)
    • Waiting for the PHP API health check
    • Setting the OPENML_USE_LOCAL_SERVICES environment variable
    • Running pytest with proper markers
    • Cleanup instructions
  • Why is this change necessary?
    The CI was recently switched to run tests against local Docker services instead of the remote test server ([MNT] Dockerized tests for CI runs using localhost #1629, [MNT] Update CI/CD with local test server and dependency matrix #1697), but the documentation was not updated to reflect this change. Contributors need clear instructions on how to replicate the CI setup locally.

  • How can I reproduce the issue this PR is solving and its solution?
    Follow the steps described in the updated docs/developer_setup.md to start the local services and run the tests with OPENML_USE_LOCAL_SERVICES=true.

- Add 'Running Tests Against Local Services' section to docs/developer_setup.md
- Add local services testing instructions to CONTRIBUTING.md
- Document the Docker-based local test server setup (clone services repo,
  set permissions, start docker compose, set OPENML_USE_LOCAL_SERVICES env var)
- Include cleanup instructions

Fixes openml#1708
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[DOC] Update documentation for running tests with local services

1 participant